home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 7 / Night Owl Shareware (NOPV7)(Night Owl Publisher Inc.)(1992).bin / 038a / bash1_12.arj / BASH1-12.TAR / bash-1.12 / builtins / reserved.def < prev    next >
Text File  |  1992-01-17  |  5KB  |  129 lines
  1. This file is reserved.def, in which the shell reserved words are defined.
  2. It has no direct C file production, but defines builtins for the help
  3. command.
  4.  
  5. Copyright (C) 1987, 1989, 1991 Free Software Foundation, Inc.
  6.  
  7. This file is part of GNU Bash, the Bourne Again SHell.
  8.  
  9. Bash is free software; you can redistribute it and/or modify it under
  10. the terms of the GNU General Public License as published by the Free
  11. Software Foundation; either version 1, or (at your option) any later
  12. version.
  13.  
  14. Bash is distributed in the hope that it will be useful, but WITHOUT ANY
  15. WARRANTY; without even the implied warranty of MERCHANTABILITY or
  16. FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  17. for more details.
  18.  
  19. You should have received a copy of the GNU General Public License along
  20. with Bash; see the file COPYING.  If not, write to the Free Software
  21. Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
  22.  
  23. $BUILTIN for
  24. $SHORT_DOC for NAME [in WORDS ... ;] do COMMANDS; done
  25. The `for' loop executes a sequence of commands for each member in a
  26. list of items.  If `in WORDS ...;' is not present, then `in "$@"' is
  27. assumed.  For each element in WORDS, NAME is set to that element, and
  28. the COMMANDS are executed.
  29. $END
  30.  
  31. $BUILTIN case
  32. $SHORT_DOC case WORD in [PATTERN [| PATTERN]...) COMMANDS ;;]... esac
  33. Selectively execute COMMANDS based upon WORD matching PATTERN.  The
  34. `|' is used to separate multiple patterns.
  35. $END
  36.  
  37. $BUILTIN if
  38. $SHORT_DOC if COMMANDS; then COMMANDS; [else COMMANDS;] fi
  39. `if' executes the `then' COMMANDS only if the final command in the
  40. `if' COMMANDS has an exit status of zero.
  41. $END
  42.  
  43. $BUILTIN while
  44. $SHORT_DOC while COMMANDS; do COMMANDS; done
  45. Expand and execute COMMANDS as long as the final command in the
  46. `while' COMMANDS has an exit status of zero.
  47. $END
  48.  
  49. $BUILTIN until
  50. $SHORT_DOC until COMMANDS; do COMMANDS; done
  51. Expand and execute COMMANDS as long as the final command in the
  52. `until' COMMANDS has an exit status which is not zero.
  53. $END
  54.  
  55. $BUILTIN function
  56. $SHORT_DOC function NAME { COMMANDS ; } or NAME () { COMMANDS ; }
  57. Create a simple command invoked by NAME which runs COMMANDS.
  58. Arguments on the command line along with NAME are passed to the
  59. function as $0 .. $n.
  60. $END
  61.  
  62. $BUILTIN { ... }
  63. $DOCNAME grouping_braces
  64. $SHORT_DOC { COMMANDS }
  65. Run a set of commands in a group.  This is one way to redirect an
  66. entire set of commands.
  67. $END
  68.  
  69. $BUILTIN %
  70. $DOCNAME fg_percent
  71. $SHORT_DOC %[DIGITS | WORD] [&]
  72. This is similar to the `fg' command.  Resume a stopped or background
  73. job.  If you specifiy DIGITS, then that job is used.  If you specify
  74. WORD, then the job whose name begins with WORD is used.  Following the
  75. job specification with a `&' places the job in the background.
  76. $END
  77.  
  78. $BUILTIN Variables
  79. $DOCNAME variable_help
  80. $SHORT_DOC Variable names and meanings
  81. BASH_VERSION    The version numbers of this Bash.
  82. CDPATH          A colon separated list of directories to search
  83.         when the argument to `cd' is not found in the current
  84.         directory.
  85. HISTFILE        The name of the file where your command history is stored.
  86. HISTFILESIZE    The maximum number of lines this file can contain.
  87. HISTSIZE        The maximum number of history lines that a running
  88.         shell can access.
  89. HOME            The complete pathname to your login directory.
  90. HOSTTYPE        The type of CPU and OS this version of Bash is running
  91.         under.
  92. PATH            A colon separated list of directories to search when
  93.         looking for commands.
  94. PROMPT_COMMAND  A command to be executed before the printing of each
  95.         primary prompt.
  96. PS1             The primary prompt string.
  97. TERM            The name of the current terminal type (/etc/termcap).
  98. auto_resume     Non-null means a command word appearing on a line by
  99.         itself is first looked for in the list of currently
  100.         stopped jobs.  If found there, that job is foregrounded.
  101. histchars       Characters controlling history expansion and quick
  102.         substitution.  The first character is the history
  103.         substitution character, usually `!'.  The second is
  104.         the `quick substition' character, usually `^'.
  105. history_control Set to a value of "ignorespace", it means don't enter
  106.         lines which begin with a SPC on the history list.  Set
  107.         to a value of "ignoredups", it means don't enter lines
  108.         which match the last entered line.  Unset, or any
  109.         other value than those above mean to save all lines
  110.         on the history list.
  111. hostname_completion_file
  112.         Contains the name of a file in the same format as
  113.         `/etc/hosts' that should be read when Bash needs to
  114.         complete a hostname.
  115. ignoreeof       Controls the action of the shell on receipt of an EOF
  116.         character as the sole input.  If set, then the value
  117.         of it is the number of EOF characters that can be seen
  118.         in a row as sole input characters before the shell
  119.         will exit (default 10).  When unset, EOF signifies the
  120.         end of input.
  121. no_exit_on_failed_exec
  122.         If this variable exists, the shell will not exit in
  123.         the case that it couldn't execute the file specified
  124.         in the `exec' command.
  125. notify          notify of job termination immediately.
  126. $END
  127.  
  128.  
  129.